home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / man / cat.1 / grok.1 < prev    next >
Text File  |  1995-07-25  |  9KB  |  199 lines
  1.  
  2.  
  3.  
  4.      GGGGRRRROOOOKKKK((((1111LLLL))))                  UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                  GGGGRRRROOOOKKKK((((1111LLLL))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           grok - Desktop Database Manager and GUI Builder
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.           ggggrrrrooookkkk [-h] [-d] [-v] [-t] [-T] [-f] [_f_o_r_m _q_u_e_r_y]]
  13.  
  14.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.           ggggrrrrooookkkk is a database manager that displays two-dimensional
  16.           databases using a card file paradigm. A GUI builder is
  17.           available to create user-defined applications. Grok comes
  18.           with a number of pre-built applications such as a phone
  19.           directory, todo lists, and a sample country database. The
  20.           form to display (_p_h_o_n_e, _t_o_d_o, _c_o_u_n_t_r_i_e_s, etc.) can be given
  21.           as the first parameter. This manual page describes the
  22.           command line options of ggggrrrrooookkkk.  For information on how to use
  23.           ggggrrrrooookkkk, refer to the on-line help pages, and to the PostScript
  24.           or TeX manual.
  25.  
  26.         OOOOPPPPTTTTIIIIOOOONNNNSSSS
  27.           -h   List available options.
  28.  
  29.           -d   Print fallback X resources and exit. The output can be
  30.                appended directly to the ~/.Xdefaults file for
  31.                modification of the geometry, color, and font defaults.
  32.  
  33.           -v   Print the program version and patchlevel and exit.
  34.  
  35.           -t   Requires specification of a form. Without a query
  36.                string, prints all cards to stdout in the same format
  37.                that is used for the summary window in interactive
  38.                mode. If a query is also specified, print only cards
  39.                that satisfy the query expression (see below). The form
  40.                may have a default query built in.
  41.  
  42.           -T   This option is equivalent to -t, but omits the header
  43.                line.
  44.  
  45.           -f   Don't fork on startup. This is useful for debugging.
  46.  
  47.           form Specifies the database to display.  GGGGrrrrooookkkk distinguishes
  48.                forms and databases. Both always come in pairs. The
  49.                form defines the representation of the cards and the
  50.                database provides the raw data. If no form is
  51.                specified, one can be chosen in interactive mode. The
  52.                -t and -T options require a form argument.
  53.  
  54.           query
  55.                If the form has a built-in query, it is used to select
  56.                which cards in the database to display initially. If
  57.                there is no default query, all cards are displayed. The
  58.                query argument can be used to override the default
  59.                query.  This option should always be quoted with single
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 6/30/95)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      GGGGRRRROOOOKKKK((((1111LLLL))))                  UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                  GGGGRRRROOOOKKKK((((1111LLLL))))
  71.  
  72.  
  73.  
  74.                quotes to keep the shell from interpreting the query
  75.                string.
  76.  
  77.           There are different types of queries: '*' selects all cards,
  78.           '/string' performs a case-insensitive string search,
  79.           '{expr}' selects all cards for which the string expression
  80.           returns a non-null, non-'f' string, and '(expr)' selects all
  81.           cards for which the numerical expression returns nonzero.
  82.           The leading '/' in string searches is optional. For a
  83.           detailed description of query expressions, refer to the
  84.           "Expression Grammar" item in the help pulldown, or to the
  85.           PostScript user's manual.
  86.  
  87.           In addition to these options, ggggrrrrooookkkk supports the usual X
  88.           options such as -iconic. The -geometry option should not be
  89.           used to preset a window size; grok determines and frequently
  90.           adjusts its own size.
  91.  
  92.      EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  93.           ggggrrrrooookkkk
  94.  
  95.           Start up grok with no form. The Database pulldown can be
  96.           used to choose one.
  97.  
  98.           ggggrrrrooookkkk pppphhhhoooonnnneeee
  99.  
  100.           Start up grok with the _p_h_o_n_e form. Perform that form's
  101.           default query if it has one.
  102.  
  103.           ggggrrrrooookkkk pppphhhhoooonnnneeee ''''////tttthhhhoooommmmaaaassss''''
  104.  
  105.           Start up grok with the _p_h_o_n_e form. Ignore the default query
  106.           and select only cards that contain the word "thomas". Case
  107.           is ignored.
  108.  
  109.           ggggrrrrooookkkk ----tttt pppphhhhoooonnnneeee ''''////tttthhhhoooommmmaaaassss''''
  110.  
  111.           Print all cards of the form _p_h_o_n_e to stdout that contain the
  112.           string "thomas". Do not start the interactive user
  113.           interface.
  114.  
  115.           ggggrrrrooookkkk pppphhhhoooonnnneeee ''''{{{{____ggggrrrroooouuuupppp ======== """"ffff"""" &&&&&&&& ____eeeemmmmaaaaiiiillll}}}}''''
  116.  
  117.           Start up grok with the _p_h_o_n_e form. Ignore the default query
  118.           and select only cards that describe friends that have an
  119.           email address.
  120.  
  121.      FFFFIIIILLLLEEEESSSS
  122.           Below, GBIN and GLIB refer to the installation directories
  123.           specified at the beginning of the Imakefile when the
  124.           programs were compiled. They are /usr/local/bin and
  125.           /usr/local/lib, respectively, by default.
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 6/30/95)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      GGGGRRRROOOOKKKK((((1111LLLL))))                  UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                  GGGGRRRROOOOKKKK((((1111LLLL))))
  137.  
  138.  
  139.  
  140.           *.gf              Files ending with the extension .gf are
  141.                             assumed to contain ggggrrrrooookkkk forms.
  142.  
  143.           *.db              Unless the form specifies otherwise, the
  144.                             database that provides the raw data for a
  145.                             form has the same path and name as the
  146.                             form, but with the extension .db.
  147.                             Procedural databases have no extension.
  148.  
  149.           .                 The current directory is searched first
  150.                             for form files.
  151.  
  152.           ./grokdir         The grokdir current directory is searched
  153.                             next for form files. This is done to allow
  154.                             ggggrrrrooookkkk to be started from the source
  155.                             distribution directory for evaluation.
  156.  
  157.           ~/.grok           By default, all forms and databases are
  158.                             stored here. By convention, all private
  159.                             forms and databases are stored here. This
  160.                             directory is searched after . and
  161.                             ./grokdir.
  162.  
  163.           GLIB/grokdir      This directory is searched last. It is
  164.                             supposed to contain forms visible to all
  165.                             users of a system. Only one user should
  166.                             have write permission.
  167.  
  168.           ~/.grok/.grokrc   Preferences and the current configuration
  169.                             of ggggrrrrooookkkk....
  170.  
  171.           GBIN/grok         The ggggrrrrooookkkk executable. This should be in the
  172.                             user's search path. Form files are set up
  173.                             so they can be "executed" by feeding
  174.                             themselves to ggggrrrrooookkkk,,,, as long as ggggrrrrooookkkk is in
  175.                             the search path $PATH.
  176.  
  177.           GLIB/grok.hlp     All help texts used by the ggggrrrrooookkkk help
  178.                             system.
  179.  
  180.         AAAAUUUUTTTTHHHHOOOORRRR
  181.           Thomas Driemeyer <thomas@bitrot.in-berlin.de>
  182.  
  183.           Please send all complaints, comments, bug fixes, and porting
  184.           experiences to me. Always include your ggggrrrrooookkkk version as
  185.           reported by "grok -v" in your mail. New forms for inclusion
  186.           in the distribution are welcome. Make sure that your email
  187.           address is in the form's comment field, and that there is
  188.           some help information attached to the form with the Def Help
  189.           function.
  190.  
  191.  
  192.  
  193.  
  194.  
  195.      Page 3                                          (printed 6/30/95)
  196.  
  197.  
  198.  
  199.